post:
  summary: Retrieve a Temporary Access Token
  description: Retrieve a Temporary Access Token
  tags:
    - Authentication
  operationId: login
  requestBody:
    content:
      application/json:
        schema:
          type: object
          required: [email, password]
          properties:
            email:
              type: string
              example: admin@example.com
              description: Email address of the user you're retrieving the access token for.
            password:
              type: string
              description: Password of the user.
              format: password
              example: password
            mode:
              type: string
              enum: [json, cookie, session]
              default: json
              description: Whether to retrieve the refresh token in the JSON response, or in a httpOnly cookie.
            otp:
              type: string
              description: The user's one-time-password (if MFA is enabled).
  responses:
    '200':
      description: Successful authentification
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                type: object
                properties:
                  access_token:
                    type: string
                    example: eyJhbGciOiJI...
                  expires:
                    type: integer
                    example: 900
                  refresh_token:
                    type: string
                    example: yuOJkjdPXMd...
